home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / doorware / wall101.zip / WALL.DOC < prev    next >
Text File  |  1996-11-26  |  20KB  |  477 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                  ─────────────────────────────────────────────
  7.                                 The Wall v1.01
  8.                  Copyright 1995-1996 Legacy Software Creations
  9.                     Designed and Programmed by Ryan Thompson
  10.                               All Rights Reserved
  11.                  ─────────────────────────────────────────────
  12.                           Distributed with the help of
  13.                       International Digital Communications
  14.                    (306)384-7685 (306)384-7682 (306)384-7680
  15.                     Three numbers to access all five lines!
  16.                         Saskatoon, Saskatchewan  CANADA
  17.                  ─────────────────────────────────────────────
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25. ────────────────────────────────────────────────────────────────────────────────
  26.  a. Table of Contents
  27. ────────────────────────────────────────────────────────────────────────────────
  28.      i)     What is The Wall?
  29.  
  30.      ii)    Specific Features
  31.  
  32.      iii)   Requirements
  33.  
  34.      iv)    Included Files
  35.  
  36.      v)     Maximus Auto-Install
  37.  
  38.      vi)    Generic BBS Install
  39.  
  40.      vii)   SETUP.EXE Detailed Help
  41.  
  42.      viii)  Multi-node Information
  43.  
  44.      ix)    Obtaining New Releases
  45.  
  46.      x)     Contacting information
  47.      
  48.  
  49.  
  50. ────────────────────────────────────────────────────────────────────────────────
  51.  i) WHAT IS THE WALL?
  52. ────────────────────────────────────────────────────────────────────────────────
  53.  
  54.      The Wall  is a  convenient  place  for users  of your  bulletin  board
  55.      service (BBS) to chat freely amongst themselves.  Many users who would
  56.      not dare touch a message menu will gladly opt to  write their thoughts
  57.      on The Wall.   It has  been found to be very easy to get along with by
  58.      novice and expert users alike.
  59.  
  60.  
  61. ────────────────────────────────────────────────────────────────────────────────
  62.  ii) SPECIFIC FEATURES
  63. ────────────────────────────────────────────────────────────────────────────────
  64.  
  65.       * Advanced ANSI (text graphics) support - animated menus, etc.
  66.         No ANSI.SYS is required to view ANSI locally.
  67.  
  68.       * Stream-lined configuration program complete with online help
  69.         to make setup changes easier than ever
  70.  
  71.       * Intelligent  BBS searching option allows Maximus  SysOps the
  72.         comfort of having their BBS information PRE-INSTALLED!
  73.  
  74.       $ High level RIPScrip graphics support
  75.  
  76.       * Support for locked baud rates of up to 115200 BPS
  77.  
  78.       * Support for COM ports 1 through 8, as well as local only settings
  79.  
  80.       * Very fast operation, quick responses, quick display
  81.  
  82.       $ COMPLETE control of who may access The Wall.  SysOps can lock
  83.         individual users out of The Wall for a specific amount of days,
  84.         as well as revoking a ban before it expires.
  85.  
  86.       * SysOps may 'trim' The Wall to a specified number of the NEWEST
  87.         lines.  This prevents The Wall from getting 'stale' by users
  88.         having to wade through VERY OLD messages.  This option keeps the
  89.         threads fresh, without having to erase the ENTIRE file, as many
  90.         of the competitors require.
  91.  
  92.       * SysOps may remove individual messages from The Wall.  This
  93.         allows full CENSORING of your users!  Register today and support
  94.         your local communist party!
  95.  
  96.       $ SysOps may ALTER the 'who from' line of any message.  With
  97.         this, you can manipulate who wrote what.  For the game-playing
  98.         SysOps out there, this can REALLY make your users wonder what
  99.         is going on.
  100.  
  101.       $ Registered SysOps can have the above mentioned 'trimming'
  102.         process done ON THE SPOT after each post.  This will ensure that
  103.         The Wall STAYS at your desired length, without requiring constant
  104.         monitoring.
  105.  
  106.       $ Support for over 250 concurrent nodes.  No matter how busy your
  107.         BBS is, users will ALWAYS be able to access The Wall.
  108.  
  109.       * Users may insert colours in their messages.  Much more creativity
  110.         is allowed!
  111.  
  112.       * Messages may be one to ten lines in length.  Many 'one liner'
  113.         type programs are on the market, and many 'lotsa liner' programs
  114.         as well.
  115.  
  116.       $ Highly intelligent profanity filter.  The Wall will promptly
  117.         boot any user who enters a swear word OUT of the program.
  118.  
  119.       * Support for DORINFO1.DEF, DOOR.SYS and LASTUS??.BBS
  120.  
  121.       $ Removal of all annoying NAG screens and delays
  122.  
  123.       ($) Denotes features available only after registering.
  124.  
  125.  
  126.  
  127. ────────────────────────────────────────────────────────────────────────────────
  128.  iii) REQUIREMENTS
  129. ────────────────────────────────────────────────────────────────────────────────
  130.  
  131.       The Wall requires the following hardware and/or software:
  132.  
  133.       * 80k of FREE conventional memory
  134.  
  135.       * Approximately 200k of free hard drive space
  136.  
  137.       * A revision 5 or higher FOSSIL driver on COM
  138.         port 1-8 ONLY if you wish to have remote users
  139.         on The Wall
  140.  
  141.       * Remote users must have an ANSI terminal
  142.  
  143.       * One of DORINFO1.DEF, DOOR.SYS, LASTUS??.BBS or CHAIN.TXT
  144.         must be correctly supported by your BBS to allow
  145.         for remote users.
  146.  
  147.  
  148. ────────────────────────────────────────────────────────────────────────────────
  149.  iv)  INCLUDED FILES
  150. ────────────────────────────────────────────────────────────────────────────────
  151.  
  152.       The following files should be present in the distribution archive:
  153.  
  154.       WALL.EXE       Main executable
  155.       WALL.DOC       Documentation  (This file)
  156.       WALL.ANS       SysOp-Alterable ANSI main menu
  157.       SETUP.EXE      Integrated configuration program
  158.       REGISTER.FRM   Registration form
  159.  
  160.  
  161. ────────────────────────────────────────────────────────────────────────────────
  162.  v)  MAXIMUS INSTALLATION
  163. ────────────────────────────────────────────────────────────────────────────────
  164.  
  165.       If you are a Maximus SysOp,  installing The Wall couldn't POSSIBLY be
  166.       simpler!   The Wall is now able to find your existing copy of Maximus
  167.       and automate the installation process!  Here's how:
  168.  
  169.       1) Run SETUP.EXE
  170.       2) Select 'YES' when asked to create a new configuration
  171.       
  172.       The Wall will create the file WALL.BAT  in the current directory.  It
  173.       will then update  your MENUS.CTL  file.  Please note,  The Wall  will
  174.       save your current MENUS.CTL in the event that you wish to reverse the
  175.       changes it has made.
  176.  
  177.       * Note: For this option to work, SETUP.EXE must be able to find
  178.               a copy of Maximus!   You must either have  the MAXIMUS=
  179.               environment variable set (required for Maximus 3.0), or
  180.               have Maximus situated in the standard x:\MAX\ directory
  181.               of your drive.  If  you cannot meet either requirement,
  182.               you may specify a pathname on the command line when you
  183.               run SETUP.EXE.  ie:
  184.  
  185.               C:\> SETUP C:\BBS\MAX\LINE1\
  186.  
  187.       If you have multiple copies of Maximus installed, you may also wish
  188.       to take advantage of the command  line option to  force The Wall to
  189.       update a particular installation.
  190.  
  191.       
  192. ────────────────────────────────────────────────────────────────────────────────
  193.  vi)  GENERIC BBS INSTALLATION
  194. ────────────────────────────────────────────────────────────────────────────────
  195.  
  196.       The following procedure applies to SysOps of non-Maximus BBSes. While
  197.       The Wall supports Maximus directly,  full functionality  has been pre-
  198.       served for all other BBS types.  Therefore,  this installation should
  199.       not be any more difficult than any other door file installation.
  200.  
  201.       1) Run SETUP.EXE:  Refer to the  SETUP.EXE configuration section
  202.          later in this manual for help with the options themselves. Be
  203.          sure you change the  BBS name and SysOp name to reflect those
  204.          of your system.  In addition, you will also need to specify a
  205.          COM port that The Wall will use to address your modem.
  206.       2) Create a  batch file to run The Wall from your BBS.
  207.       4) Change your BBS  configuration to properly shell to the batch
  208.          file you  have created.   Consult your  software's  manual if
  209.          necessary.
  210.  
  211.       That's it!  Of course,  you should test The Wall locally,  as well as
  212.       with remote users online to be sure your setup is  working correctly.
  213.  
  214.  
  215. ────────────────────────────────────────────────────────────────────────────────
  216.  vii) CONFIGURATION WITH SETUP.EXE
  217. ────────────────────────────────────────────────────────────────────────────────
  218.  
  219.      The SETUP utility was created in the hope  that documentation such as
  220.      this would never need be read by SysOps.  However,  it is included as
  221.      a more complete companion to SETUP's already adequate descriptions.
  222.  
  223.      ────────────
  224.      SysOp's Name
  225.  
  226.        The name of the SysOp belongs in this field. Since is displayed
  227.        to the users when The Wall exits, you should edit it to reflect
  228.        what you want them to see.  If you own a registered copy of The
  229.        Wall, you will not have the ability to change this field field,
  230.        because your  registration information is  built in to the prog-
  231.        ram itself.
  232.  
  233.  
  234.      ────────
  235.      BBS Name
  236.  
  237.        The name of your BBS is also displayed when The Wall exits. Reg-
  238.        istered users  of The Wall do  not have  the ability  to change
  239.        this field.   In the  event that  you have  changed BBS  names,
  240.        please  contact  the author and you will be sent a replacement.
  241.  
  242.         -> Refer to "Contacting Information" for author's addresses
  243.  
  244.  
  245.      ────────
  246.      BBS Path
  247.  
  248.        The path you specify in this field tells The Wall where to look
  249.        for your drop files.  You should generally have this set to the
  250.        root directory of your BBS installation.
  251.  
  252.  
  253.      ────────────────
  254.      Default COM port
  255.  
  256.        This  option is  of particular  use  to SysOps only running one
  257.        line.  It  defines the default modem port that will be accessed
  258.        if none is  given on  the command  line.  If you are using more
  259.        than one COM port on your BBS, however, you should refer to the
  260.        MULTINODE OPERATION section for details on setup.
  261.  
  262.  
  263.      ────────
  264.      BBS Path
  265.  
  266.        Your BBS path MUST reflect the FULL directory where all of your
  267.        BBSes door files  are created, (such as  DORINFO1.DEF, DOOR.SYS
  268.        or LASTUS??.BBS).
  269.  
  270.  
  271.      ───────────
  272.      Status Line
  273.  
  274.        Several options for status line display are implemented.  SETUP
  275.        allows you to toggle both LOCAL and REMOTE status lines.  While
  276.        they will  NEVER be  displayed to a remote caller,  you can con-
  277.        trol when they are displayed to YOU locally. Local status lines
  278.        are only  displayed when no modem connection is present. Remote
  279.        status lines are only displayed  when there is  a remote caller
  280.        on-line.   Turning both toggles off  causes no status  lines to
  281.        ever be displayed.
  282.  
  283.  
  284.      ─────
  285.      Snoop
  286.  
  287.        This  feature  allows you to control the display of text on the
  288.        LOCAL  screen.  If  Snoop  is ON,  you  will  be  able  to  see
  289.        everything a user does on your  screen as it happens.  If Snoop
  290.        is OFF, nothing will be displayed to YOU,  but  the remote user
  291.        will  be able to  operate normally.   Note that  this does  not
  292.        affect  LOCAL ONLY sessions.  The  possible  uses  for  an  OFF
  293.        setting are twofold.  Firstly, on slow machines, displaying the
  294.        ANSI files and the rest of the text can take time, slowing down
  295.        the display  slightly  for the remote user.  If  you spend very
  296.        little time watching your users, you may want to take advantage
  297.        of  this   very  small  boost  in  speed.   Secondly,  in  some
  298.        multitasking  situations, output can be interpreted incorrectly
  299.        causing 'garbage' or 'bleeding' on your desktop.  Displaying no
  300.        text at all seems the safest way around the problem.
  301.  
  302.  
  303.      ──────────────
  304.      Drop File Type
  305.  
  306.        Choosing the correct door file type is critical to successfully
  307.        running The Wall.   Many  BBSes are capable  of producing  more
  308.        than one type of drop file; in this case, it is up to you which
  309.        one to use.  The Wall supports three door types, as follows:
  310.  
  311.        DORINFO1.DEF - This is the standard  RBBS format drop file sup-
  312.                       ported  by many BBS types.   For the 'multinode'
  313.                       DORINFO configuration, refer to the next option.
  314.  
  315.        DORINFO?.DEF - This is to be used for BBSes which use the multi
  316.                       node version of DORINFO.DEF.   The ? is replaced
  317.                       with the current node number.
  318.  
  319.        CHAIN.TXT    - The WWIV BBS package uses this format.
  320.  
  321.        DOOR.SYS     - Also popular,  DOOR.SYS is predominantly used by
  322.                       older BBS packages,  but is  supported by nearly
  323.                       all types.
  324.  
  325.        LASTUS??.BBS - LASTUSER.BBS,  or LASTUS##.BBS  with ##  as  the
  326.                       node  number  of  the user  are both  supported.
  327.                       These are generated by all versions of  Maximus.
  328.                       The Wall  can interpret both Maximus 2.x and 3.x
  329.                       formats.
  330.  
  331.                     **If you are using the ## node number format,
  332.                       refer to "MULTINODE OPERATION"
  333.  
  334.   
  335.      ──────────────
  336.      Time-out Limit
  337.  
  338.        This value is expressed in seconds, and refers to the amount of
  339.        time that The  Wall will  wait for  an inactive  user to make a
  340.        keystroke.   If no  key is pressed for this amount of time, The
  341.        Wall will report a timeout and return to the BBS, without
  342.        hanging up on the user.
  343.  
  344.  
  345.      ──────────────────────
  346.      Local Inactive Timeout
  347.  
  348.        If you do not want to be restricted to a set time of inactivity
  349.        while in a local session,  you should  toggle this  option OFF.
  350.        In sessions where  no remote  user is  online,  the  inactivity
  351.        timeout will NOT be in effect.  Therefore, if you are concerned
  352.        that  you  or  someone  else may  accidentally  leave  The Wall
  353.        running and unattended,  you should  leave this  option ON  for
  354.        maximum security.
  355.  
  356.  
  357.      ────────────────
  358.      Maximum Messages ($)
  359.  
  360.        Registered  users may  set  this value  to the  amount of  user
  361.        messages they wish to keep on The Wall at a  time.  In essence,
  362.        this handles  trimming AUTOMATICALLY,  allowing The Wall to run
  363.        virtually maintenance-free.  The  OLDEST lines  will be deleted
  364.        as NEW lines are posted.  Eg:
  365.  
  366.        You have  set Maximum  Messages to 20,  and there are currently
  367.        20  posts  on The  Wall.  When  a user  enters a  new post, the
  368.        OLDEST  post (ie  at the  top of  the  list)  will be  removed,
  369.        keeping the total to 20 messages.
  370.  
  371.        Note:  If you  do not  wish The  Wall to  preform any automatic
  372.        trimming, set Maximum Messages to 0.
  373.  
  374.  
  375.      ────────────────
  376.      Profanity Filter ($)
  377.  
  378.        Registered SysOps can enjoy the freedom of a much cleaner Wall.
  379.        If this feature  is turned  ON, The Wall will  look closely  at
  380.        what text  the user  wrote,  and  if ANY  profane language  was
  381.        found,  he or  she  will  be  swiftly  booted  from  The  Wall.
  382.        Advanced word detection  is used,  so simple case  differences,
  383.        spacing, and punctuation are all ignored. If the word 'WINDOWS'
  384.        was a swear, The Wall would find:
  385.  
  386.          WIN DOWS, W1ND0WS, WIN, DO! W, SEE!, and countless
  387.          other combinations along the same thought patterns.
  388.  
  389.        Even with this option turned ON, you should still make an effort
  390.        to keep an eye on the content if desired.  The English  language
  391.        has many, many different meanings for its many words. Nearly any
  392.        phrase can be put  in a different context to insinuate a profane
  393.        remark.  Full artificial  intelligence is  marginally beyond the
  394.        scope of this simple program. :-)
  395.  
  396.  
  397. ────────────────────────────────────────────────────────────────────────────────
  398.  viii) MULTINODE OPERATION
  399. ────────────────────────────────────────────────────────────────────────────────
  400.  
  401.      The Wall is fully multi-node aware.  This essentially means that it is
  402.      intelligent  enough to  know that  someone else is currently using the
  403.      program, and should not try to interfere.   Users who  try and  access
  404.      The Wall while someone else  is currently inside will be told to wait,
  405.      and be returned to the BBS.
  406.  
  407.      Registered users  are able to run multiple copies of The Wall, thereby
  408.      allowing multiple users to access it at one time.
  409.  
  410.      If you are running more than  one node,  especially if  you are  using
  411.      Maximus'  LASTUS##.BBS  specification,  you  must  pass  WALL.EXE  the
  412.      current  task number on the  command line.   For example, node 2 would
  413.      require:
  414.  
  415.           WALL.EXE 2
  416.  
  417.      If no node is specified, multi-node detection  will  still occur,  but
  418.      The Wall will default to LASTUSER.BBS, not LASTUS##.BBS.
  419.  
  420.      The Wall will  also accept a  COM port  via the  command line,  in the
  421.      event  that you  are running  several modems  on the same machine, and
  422.      require  different COM  ports  to  be used.   For example,  if you are
  423.      running The Wall on node 2 with a modem on COM4, specify:
  424.  
  425.           WALL.EXE 2 4
  426.  
  427.      Please note that the node number  must be FIRST, the COM  port must be
  428.      LAST.  You may only  specify a com port if you specify a  node number.
  429.      This format  was intentionally kept  simple to allow a small number of
  430.      limited BBS packages the ability to use The Wall properly.
  431.  
  432.  
  433. ────────────────────────────────────────────────────────────────────────────────
  434.  ix) OBTAINING NEW RELEASES
  435. ────────────────────────────────────────────────────────────────────────────────
  436.  
  437.      The newest version of The Wall can be obtained by any of the following
  438.      methods.
  439.  
  440.      Internet: Send  an  E-mail  message  to legacy@eagle.wbm.ca  with  the
  441.                subject  line 'GRAB WALL', and it will be automatically sent
  442.                to your return address.
  443.  
  444.      Internet: Get the net!  Check out the Maximus home page at
  445.                           http://oeonline.com/~garyg
  446.                               or the FTP site at
  447.                          ftp.oeonline.com/pub/maximus
  448.  
  449.      FidoNet:  File request WALL from 1:140/223
  450.  
  451.      MaxFDN:   The Wall is also on  MaxFDN!  Check  it  out at a  download
  452.                site near you!   Questions about  MaxFDN should  be sent to
  453.                garyg@oeonline.com, or NetMail'd to 1:2410/400.
  454.  
  455.  
  456. ────────────────────────────────────────────────────────────────────────────────
  457.  ix) CONTACTING INFORMATION
  458. ────────────────────────────────────────────────────────────────────────────────
  459.  
  460.      Ryan Thompson (The Author) may be reached by the following methods.
  461.      E-Mail, NetMail or a BBS call are the preferred methods, as replies
  462.      tend to come back very quickly.
  463.  
  464.      Internet E-Mail:   legacy@eagle.wbm.ca
  465.  
  466.      FidoNet E-Mail:    1:140/223.0 To: "Legacy Software"
  467.  
  468.      Author BBS:        (306)384-7685  (28.8kbps) Saskatoon, SK  CANADA
  469.                         (306)384-7682  (14.4kbps)
  470.                         (306)384-7680  (14.4kbps)
  471.                         Legacy files available immediately
  472.  
  473.      Snail Mail:        Legacy Software Creations
  474.                         P.O. Box 7335
  475.                         Saskatoon, Saskatchewan
  476.                         CANADA  S7K 4J2
  477.